package com.pethospital.dao;

import com.pethospital.entity.PageResult;
import com.pethospital.entity.User;

import java.util.List;

/**
 * 用户数据访问接口
 * User Data Access Object Interface
 * 
 * @author PetHospital System
 * @version 1.0
 */
public interface UserDao {
    
    /**
     * 根据用户名和密码查询用户（登录验证）
     * 
     * @param username 用户名
     * @param password 密码
     * @return User 用户对象，如果不存在返回null
     */
    User findByUsernameAndPassword(String username, String password);
    
    /**
     * 根据用户名查询用户
     * 
     * @param username 用户名
     * @return User 用户对象，如果不存在返回null
     */
    User findByUsername(String username);
    
    /**
     * 根据用户ID查询用户
     * 
     * @param userId 用户ID
     * @return User 用户对象，如果不存在返回null
     */
    User findById(Integer userId);
    
    /**
     * 添加用户
     * 
     * @param user 用户对象
     * @return int 影响的行数
     */
    int insert(User user);
    
    /**
     * 更新用户信息
     * 
     * @param user 用户对象
     * @return int 影响的行数
     */
    int update(User user);
    
    /**
     * 删除用户
     * 
     * @param userId 用户ID
     * @return int 影响的行数
     */
    int delete(Integer userId);
    
    /**
     * 批量删除用户
     * 
     * @param userIds 用户ID数组
     * @return int 影响的行数
     */
    int batchDelete(Integer[] userIds);
    
    /**
     * 查询所有用户
     * 
     * @return List<User> 用户列表
     */
    List<User> findAll();
    
    /**
     * 分页查询用户
     * 
     * @param currentPage 当前页码
     * @param pageSize 每页大小
     * @return PageResult<User> 分页结果
     */
    PageResult<User> findByPage(int currentPage, int pageSize);
    
    /**
     * 根据条件分页查询用户
     *
     * @param username 用户名（模糊查询）
     * @param realName 真实姓名（模糊查询）
     * @param userType 用户类型
     * @param status 状态
     * @param currentPage 当前页码
     * @param pageSize 每页大小
     * @return PageResult<User> 分页结果
     */
    PageResult<User> findByCondition(String username, String realName, String userType,
                                   String status, int currentPage, int pageSize);

    /**
     * 根据条件分页查询用户（带排序）
     *
     * @param username 用户名（模糊查询）
     * @param realName 真实姓名（模糊查询）
     * @param userType 用户类型
     * @param status 状态
     * @param sortField 排序字段
     * @param sortOrder 排序方向（asc/desc）
     * @param currentPage 当前页码
     * @param pageSize 每页大小
     * @return PageResult<User> 分页结果
     */
    PageResult<User> findByConditionWithSort(String username, String realName, String userType,
                                           String status, String sortField, String sortOrder,
                                           int currentPage, int pageSize);
    
    /**
     * 统计用户总数
     * 
     * @return long 用户总数
     */
    long countAll();
    
    /**
     * 根据用户类型统计用户数量
     *
     * @param userType 用户类型
     * @return long 用户数量
     */
    long countByUserType(String userType);

    /**
     * 统计今日注册用户数量
     *
     * @return long 今日注册用户数量
     */
    long countTodayRegistered();
    
    /**
     * 检查用户名是否存在
     * 
     * @param username 用户名
     * @return boolean 是否存在
     */
    boolean existsByUsername(String username);
    
    /**
     * 检查邮箱是否存在
     * 
     * @param email 邮箱
     * @return boolean 是否存在
     */
    boolean existsByEmail(String email);
    
    /**
     * 更新用户状态
     * 
     * @param userId 用户ID
     * @param status 状态
     * @return int 影响的行数
     */
    int updateStatus(Integer userId, String status);
    
    /**
     * 更新用户密码
     * 
     * @param userId 用户ID
     * @param newPassword 新密码
     * @return int 影响的行数
     */
    int updatePassword(Integer userId, String newPassword);
}
